home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / picview / pvdoc.txt < prev    next >
Text File  |  1990-01-22  |  12KB  |  357 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                            PicView 0.9beta
  31.                     An alternative picture Viewer
  32.              Copyright 1989 by Greg Thomas & Brad Mettee
  33.  
  34.  
  35.  
  36.  
  37.  
  38. What is PicView?
  39.  
  40.       PicView is an alternative picture viewer that offers features
  41. not found in any other Picture viewer elsewhere.  This is not the end
  42. all program (yet).  Other viewers do offers some features that PicView
  43. does not, such as graphic conversion.  Some of the 'deficiencies' of
  44. PicView will be added to later releases.
  45.  
  46.       Currently PicView will read and display 2 graphic formats. 
  47. These are GIF and MAC formats.  We are currently working on
  48. implementing more formats, notably RIX SC? files, PCX and Deluxe Paint
  49. LBM files.  Other formats are being looked into, and will be
  50. implemented as we accrue information on them.  (As well as a
  51. proprietary format that contains information for PicView.
  52.  
  53.  
  54.  
  55.  
  56. What makes PicView different than these other viewers?
  57.  
  58.       Ahh glad you asked that question (you did ask that, didn't
  59. you?)  Well, for starters, our biggest pride with this product is the
  60. superb ADJUSTABLE palette animation.  A picture can be animated
  61. through the entire palette, a portion of the palette, and through a
  62. range of colors in the palette.  The effects of the animation must be
  63. seen to be truly appreciated.
  64.  
  65.  
  66.       It also sports a very easy to use window interface that if not
  67. for the complex animation abilities, would preclude the need for docs
  68. at all.  It uses very easy pop-down windows for all parameter setting
  69. and selection very similar to the environments used in Borland's
  70. Language's (Guess will have to look out for the look and feel police.)
  71.  
  72.  
  73.       Currently, it supports the SVGA (or EVGA if you prefer) modes of
  74. the ATI VGA wonder and small wonder.  It will auto detect if these
  75. adapters are installed, and adjust the mode selections (screen size)
  76. accordingly.  Other chip sets such as Vega, Tseng, Paradise, etc. are
  77. on the way, and should be ready shortly.  Also, for you True Blue
  78. users, a special 360x480x256 mode is in the works for you to get
  79. almost SVGA performance out of your motherboard VGA (expect this to be
  80. in release 1.0 shortly).  PicView currently (and most likely won't
  81. ever) does NOT support standards less then VGA.  There are several
  82. viewers on the market that support EGA and below, so it seemed rather
  83. pointless since PicView's animation abilities are best done on VGA.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.       Files contained in PicView.zip
  91.          PV.EXE            PicView executable file
  92.          
  93.          PVDOC.TXT         PicView documentation
  94.          
  95.          REGISTER.TXT      PicView registration form
  96.          
  97.          PICVIEW.GIF       PicView.gif is a gif file which 
  98.                            demonstrates the viability of partial 
  99.                            palette animation.  Using the random 
  100.                            palette (any palette will do, but works 
  101.                            best with random or plasma) set starting 
  102.                            register to 92, and end register to 112.
  103.          
  104.          WAVE.GIF          Wave.gif and boxes.gif both have 
  105.          BOXES.GIF         continous smooth palettes making 
  106.                            experimentation of the default palette's 
  107.                            possible settings.
  108.  
  109.  
  110.  
  111.  
  112. In the Works
  113.      Some of the features that PicView will be incorporating in
  114. future releases are:
  115.     360x480x256 for IBM and all register compatible VGA cards.
  116.     A script language for slideshow presentations.
  117.     Support for other SVGA cards.
  118.     Support for more file formats i.e. PCX, LBM, etc.
  119.     Hot key access to menu choices.
  120.  
  121.  
  122.  
  123.  
  124.                      Getting Started with PicView
  125.  
  126.  
  127.       To start PicView, simply type pv at the dos prompt.  A credit
  128. screen will pop up, and after a short pause, will take you to the main
  129. menu.  From the main menu, you have 5 choices, detailed here.
  130.  
  131.  
  132.  
  133.  
  134. Info
  135.  
  136.       Pops up the opening credit screen.  (In case you get bored, or
  137. want to know who wrote this contraption.)
  138.  
  139.  
  140.  
  141. File
  142.  
  143.       Pops up a sub menu used for file selection.
  144.  
  145.  
  146.  
  147. Environ
  148.  
  149.       Pops up submenu for options pertaining to environment.
  150.  
  151.  
  152.  
  153. Options
  154.  
  155.       Brings up a submenu to select PicView's options.
  156.  
  157.  
  158.  
  159. Exit
  160.  
  161.       Exits the program. (That's a hard one to figure out, eh?)
  162.  
  163.  
  164.  
  165.  
  166. Submenus have a varying number of selections that either pop up an
  167. additional submenu, prompt you for data, or display a selected file. 
  168. Submenu options will be detailed here.
  169.  
  170.  
  171.  
  172.  
  173. File
  174.     
  175.     Select File(s)
  176.     
  177.          This selection pops up a file selection window which allows
  178.     you to select the file to be viewed.  The window sports a scroll
  179.     bar to give you an indication of how far along you are in the
  180.     list of files.  There is a real file limit of 16,000 files that
  181.     can be read into the directory (assuming you have a 640k 
  182.      
  183.      
  184.      
  185.      machine).  You can use first character selection to speed you
  186.      through your files. Hitting 'T' once will take you to the first
  187.      file beginning with T.  Hitting it again will take you to the
  188.      next and so on.  The list can be scrolled beyond the end or
  189.      beginning if scrolling in reverse.  When you find the file you
  190.      want to display, Hit the 'ENTER' key and it will be displayed. 
  191.      After the file has been displayed, strike any key to return to
  192.      the file selection window.  When you return, you will have the
  193.      last file displayed still highlighted.
  194.      
  195.      
  196.      File Type
  197.      
  198.           This selection will pop up a little window that allows you
  199.      to select which type of file you wish to have in the selection
  200.      window above.  Currently you have two choices, GIF and MAC. 
  201.      This will be expanding in the near future.
  202.      
  203.      
  204. Environ
  205.     
  206.     Screen
  207.     
  208.          This will pop up a submenu allowing you to select which
  209.     screen mode you want the picture displayed in.  Depending on
  210.     your video adapter, you may not be able to select all of the
  211.     choices.  If you have an ATI VGA Wonder with 512k, you can
  212.     select from any mode, including the Auto select option which
  213.     will let the program select the best video mode for the picture
  214.     to fit in.
  215.     
  216.     
  217. Options
  218.     
  219.     Animate
  220.     
  221.          This will pop up a window prompting you for data to control
  222.     the animation facilities of PicView.  The first data item you
  223.     are prompted for is whether or not you want animation on.  If
  224.     you select 'N', the window is dropped, and you are returned to
  225.     the next level up menu.  If you select 'Y', you are then
  226.     prompted for the direction, palette, starting and ending
  227.     registers, and depending on the palette selected, starting and
  228.     ending color data.  More detail will be covered on this topic
  229.     later.
  230.     
  231.     
  232. Exit
  233.     
  234.     This selection returns you to DOS.  Optionally, you can hit the
  235.     escape key at any top level menu to return to dos as well.
  236.  
  237.  
  238.  
  239.  
  240.       OK, Let me go into some details on the animation options, as
  241. some of it can be a bit confusing.
  242.  
  243.  
  244.       After selecting 'Y' to the animate prompt, your next prompt will
  245. be for the direction to animate.  View both, as the different
  246. directions can have an entirely different effect.  The direction is
  247. relative, and can/will be different from file to file (dependent on
  248. how the palette registers were laid out at the time the file was
  249. created).
  250.  
  251.  
  252.       The next prompt after selecting the direction, will be for you
  253. to select the palette.  You have 3 choices here, a random palette, the
  254. default palette, and a plasma palette (based loosely on the demo
  255. plasma).  Use experimentation here, as different images work better
  256. with different palette selections.  The random palette will look
  257. pretty good for just about any image (note:  images with smooth
  258. palette ranges animate the best).  If the default palette is laid out
  259. well without many 'holes', this one works well too.  Although, I have
  260. viewed some images that DO have 'holes' which enhanced the animation
  261. effect.  The plasma palette is based on a smooth transition of red,
  262. green and blue and restricts the animation to the first 180 or so
  263. registers (again, based loosely on the images created by the demo
  264. plasma).
  265.  
  266.  
  267.       If you select the Default palette, a window will pop up
  268. prompting your for starting and ending color.  This will be discussed
  269. in the next section as it is related to registers, but only applies to
  270. the default palette.
  271.  
  272.  
  273.       OK, I trust you've kept up with me so far.  Here's where it can
  274. get confusing.  Your next prompt is for the starting and ending
  275. color.  If you've selected either the Random or Plasma palette, this
  276. will tell the program which color register to start the animation at,
  277. and which to stop it at.  This gives you the ability to animate a
  278. portion of the image, instead of the entire image.  This works VERY
  279. well for images that use a smooth palette range in a portion of the
  280. picture.
  281.  
  282.  
  283.       Now, if you've selected the Default palette, your start and end
  284. colors take on additional meaning in conjunction with the start and
  285. end color window that popped up after you selected DEFAULT.  To give
  286. you a better understanding, picture your image like this.  Every pixel
  287. gets its color from one of 256 palette registers.  The start and end
  288. registers are exactly that, PHYSICAL registers in the machine.  The
  289. start and end colors are the color data contained in those registers. 
  290. When you select your start and end register, you are selecting the
  291. physical registers that are scrolled.  When you select the start and
  292. end color, you are selecting the range of color data that you want
  293. scrolled through those registers.  If you select a color range smaller
  294. than the palette range, the number of colors you selected will
  295. determine the number of registers scrolled.  However, if you select a
  296. smaller range of registers than colors, then the registers will scroll
  297. through the entire range of colors you selected
  298.  
  299.  
  300.  
  301.  
  302.       OK, are you thoroughly confused?  I thought so, but experiment a
  303. little after reading the docs (preferably with the images that came
  304. with the PicView file since they have smooth palette ranges, it makes
  305. it clear sooner what exactly is going on).
  306.  
  307.  
  308.  
  309.  
  310.                               SHAREWARE
  311.  
  312.  
  313. PicView is a shareware product.  You are granted a limited 15 day
  314. non-comercial use of this product. At the end of this period, if you
  315. are still using PicView, you may license PicView for non-commercial
  316. use on one machine by sending $15.00 to:
  317.  
  318. Greg Thomas & Brad Mettee
  319. c/o Greg Thomas
  320. 344 S. Oldham St.
  321. Balto., Md. 21224
  322.  
  323. PicView may be licensed for commercial use on up to 5 computers for
  324. $50.00. A commercial site is defined as a business or individual
  325. seeking to make a profit by selling PicView as part of a package,
  326. either hardware or software, use of PicView as demo to sell hardware
  327. or software.
  328.  
  329. Commercial site's requireing more copies, may contact the authors for
  330. special pricing arrangements.
  331.  
  332. All rights are reserved.
  333.  
  334. PicView may not be changed, modified or reverse engineered in any way
  335. except by the authors.  PicView may be freely distributed as long as
  336. it remains in its complete form.  Regardless of how the copy is 
  337. obtained, all users are required to comply with the licensing
  338. agreement.
  339.  
  340. All warranties are  disclaimed, including damage to hardware and/or
  341. software from use of this product.  In no event will the authors be
  342. liable for any damages, including lost profits, lost savings or other
  343. incidental or consequential damages due to your use or inability to
  344. use the program, or any other claim by any other party.
  345.  
  346. Any suggestions or comments can be mailed directly to me, emailed to
  347. me on CIS (user 73047,57) or left on my bbs:
  348.  
  349.                              Jolly Roger
  350.                             (301)675-2566
  351.                             3/12/2400 baud
  352.  
  353. GIF and Graphics Interchange Format are trademarks of Compuserve, an
  354. H+R Block Co.
  355.  
  356. IBM is a registered trademark of International Business Machines Inc.
  357.